DrawThemeChasingArrows

DrawThemeChasingArrows
Header:	Appearance.h		Carbon status:	Supported

Draws an asynchronous arrows indicator.

OSStatus DrawThemeChasingArrows (
    const Rect *bounds, 
    UInt32 index, 
    ThemeDrawState state, 
    ThemeEraseUPP eraseProc, 
    UInt32 eraseData
);

bounds: A pointer to a structure of type Rect. Before calling DrawThemeChasingArrows, set the rectangle to contain the asynchronous arrows, in local coordinates.
index: An unsigned 32-bit value. Pass a value specifying the current animation step of the arrows. To animate the arrows, increment the initial value by 1 with each call to DrawThemeChasingArrows.
state: A value of type ThemeDrawState. Pass a constant specifying the state in which to draw the asynchronous arrows indicator; see “Theme Draw State Constants”. The asynchronous arrows indicator can be drawn as active or inactive; passing kThemeStatePressed produces an error.
eraseProc: A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemeChasingArrows calls that function to erase the background before drawing the asynchronous arrows. If you pass NULL, no erasing occurs.
eraseData: An unsigned 32-bit integer. Provide any data to be passed in to the eraseData parameter of the callback function specified in the eraseProc parameter.

function result: A result code.

DISCUSSION

The DrawThemeChasingArrows function draws a theme-compliant asynchronous arrows (also known as “chasing arrows”) indicator.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.